usePixelScaling

Type

property

Summary

Determines whether or not LiveCode will automatically apply pixel scaling.

Syntax

set the usePixelScaling to { true | false }

Description

Set the usePixelScaling property to false to prevent LiveCode automatically scaling your stack.

If the usePixelScaling property is set to false, pixel scaling will be disabled and LiveCode will draw at a 1:1 scale, allowing the operating system to perform any default scaling. For example, by default, iOS will upscale stacks running on retina devices.

When the usePixelScaling property is false, the pixelScale property is set to 1 and is not modifiable.

Due to limitations of the platform, applications on Windows will not be able to enable or disable pixel scaling. On Android there is no equivalent OS-level scaling provided, so pixel scaling will always be used and attempting to set this property on Android will throw an error.

Handling multiple displays Desktop systems may have multiple displays attached, each with their own density value. On platforms that support different scale values for each display, LiveCode automatically renders each stack at the correct scale for the screen on which it is displayed.

As there may be multiple displays with differing scale values, The global systemPixelScale property returns the maximum screen density for all connected displays.

Two additional global properties have been added to provide the pixel scale values when multiple displays are available:

• The screenPixelScale property returns the pixel scale of the main screen
• The screenPixelScales property returns a return-delimited list of the pixel scale of each connected display

Examples

on preOpenStack
   set the usePixelScaling to false
end preOpenStack

Related

command: iphoneUseDeviceResolution

glossary: property

property: pixelScale, systemPixelScale, usePixelScaling, screenPixelScales, screenPixelScale

Compatibility and Support

Introduced

LiveCode 6.6

OS

mac

windows

linux

ios

android

Platforms

desktop

mobile